lsrcconsistgrp

使用 lsrcconsistgrp 命令可返回对系统可见的远程拷贝一致性组(如高速镜像、全局镜像或主动/主动一致性组)的简明列表或详细视图。

语法

阅读语法图跳过直观语法图 lsrcconsistgrp -filtervalueattribute=value-nohdr-delimdelimiter-filtervalue?object_idobject_name

参数

-filtervalue attribute=value
(可选)指定一个或多个过滤器的列表。仅显示值与过滤器属性值匹配的对象。 如果指定了容量,那么还必须包含单位。
注: 某些过滤器允许您在输入命令时使用通配符。以下规则适用于将通配符用于 IBM Spectrum Virtualize for Public Cloud 命令行界面 (CLI) 的情况:
  • 通配符为星号 (*)。
  • 命令最多可包含一个通配符,并且该通配符必须是字符串中的第一个或最后一个字符。
  • 使用通配符时,必须将过滤器条目包含在双引号 ("") 内,如下所示:
    lsrcconsistgrp -filtervalue "name=md*"
-nohdr
(可选)缺省情况下,将在简明样式视图中显示每个数据列的标题,在详细样式视图中显示每个数据项的标题。-nohdr 参数用于禁止显示这些标题。
注: 如果没有要显示的数据,那么不会显示标题。
-delim delimiter
(可选)缺省情况下,简明视图中的所有数据列都以空格分隔。每列的宽度设置为每个数据项的最大宽度。在详细视图中,每个数据项各占一行,如果显示标题,将用空格来分隔数据与标题。-delim 参数会覆盖此行为。-delim 参数的有效输入为一个单字节字符。 如果在命令行中输入 -delim :,那么在简明视图中将用冒号字符 (:) 分隔所有数据项;例如,不会出现列间距。 在详细视图中,数据与标题间以指定的定界符分隔。
object_id | object_name
(可选)指定对象的名称或标识。使用此参数时,将显示特定对象的详细视图,而忽略 -filtervalue 参数指定的所有值。如果未指定 object_id | object_name 参数,那么将显示与 -filtervalue 参数指定的过滤要求相符的所有对象的简明视图。
-filtervalue?
(可选)指定您希望报告显示有效过滤器属性列表的任何部分或全部。lsrcconsistgrp 命令的以下过滤器属性有效:
  • group_id
  • name
  • master_cluster_id
  • master_cluster_name
  • aux_cluster_id
  • aux_cluster_name
  • primary
  • state
  • relationship_count
  • id
  • copy_type

有关过滤属性的更多信息,请参阅-filtervalue 参数的属性

描述

该命令返回对系统可见的远程拷贝一致性组(如全局镜像、高速镜像或主动/主动一致性组)的简明列表或详细视图。

下表提供了在输出视图中显示为数据的属性的可能值。
表 1. lsrcconsistgrp 命令输出值
属性
primary 指示哪些卷具有主要角色。主卷可用于写入 I/O。 辅助卷不可用于写入 I/O。拷贝的方向是从主卷到辅助卷。值为 masterauxblank
state 指示状态。值包括:
  • consistent_copying
  • inconsistent_stopped
  • inconsistent_copying
  • consistent_stopped
  • consistent_synchronized
  • idling
  • idling_disconnected
  • inconsistent_disconnected
  • consistent_disconnected
  • empty
cycle_period_seconds 指示多个循环间的最短周期(以秒计)。值为 60 - 86400 之间的数字(整数)。缺省值为 300。
previous_primary 对于状态为空闲的全局镜像、高速镜像和 GMCV 关系,此字段指示该组的先前主卷。对于这些类型的组,当其状态不是空闲时,此字段为空白。对于属于 HyperSwap 组的主动/主动组,该字段未使用且为空白。有效值为空白、master 或 aux。
cycling_mode 指示要使用的全局镜像、高速镜像或主动/主动循环类型:none(缺省值)或 multi
freeze_time 指示采用 YYMMDDHHMM 格式的时间
status 指示关系状态。值包括:
  • online,指示关系联机且可访问。如果关系状态是 ConsistentSynchronizedConsistentCopyingInconsistentCopying,那么卷将复制主卷收到的主机 I/O 操作。
  • primary_offline,指示关系中的主卷已脱机。这会阻止额外的 I/O 操作且暂停同步,直到主卷再次联机为止。
  • secondary_offline,指示关系中的辅助卷已脱机。对于 ConsistentSynchronized 状态(无变更卷)的全局镜像关系和高速镜像关系,针对主卷的额外 I/O 写操作将终止关系。
  • io_channel_offline,指示远程系统不可访问。对于 ConsistentSynchronized 状态(无变更卷)的全局镜像关系和高速镜像关系,针对主卷的其他 I/O 写操作将终止关系。
  • primary_change_offline,指示关系中的主变更卷已脱机。对于具有变更卷关系的全局镜像,当前 I/O 循环将结束,当主变更卷再次联机时,开始新的 I/O 循环。
  • secondary_change_offline,指示关系中的辅助变更卷已脱机。对于具有变更卷关系的全局镜像,当前 I/O 循环将暂停,当辅助卷再次联机时,恢复新的 I/O 循环。
  • change_volumes_needed,指示 HyperSwap® 卷或具有变更卷关系的全局镜像卷中的主动/主动关系。另外,至少未配置一个变更卷。
sync 指示一致已停止还是空闲一致性组仍处于同步状态。值为 in_syncout_of_syncblank

当内容在卷之间已同步(完全相同)时,sync 属性的值为 in_sync。如果在出现一致(已停止)或空闲状态后,对主卷或辅助卷执行写操作,那么主卷或辅助卷将不再同步。

copy_type 指示拷贝类型。值包括:
  • metro
  • global
  • activeactive
  • 空白
注: 如果全局镜像或高速镜像关系或一致性组是系统间的,并且系统伙伴关系已断开连接,那么这些关系和一致性组的名称可为空白。

简明调用示例

lsrcconsistgrp -delim : 

生成的简明输出:

id:name:master_cluster_id:master_cluster_name:aux_cluster_id:aux_cluster_name:
primary:state:relationship_count:copy_type:cycling_mode:freeze_time

 248:jdemo_BA_cons1:0000020060406746:clusterB:0000020061413ABA:clusterA:master:
consistent_stopped:2:global:none:06/06/27/08/31/37
 249:rccstgrp0:0000020061413ABA:clusterA:0000020061413ABA:clusterA::empty:0
:empty_group
 250:jdemo_BA_cons2:0000020060406746:clusterB:0000020061413ABA:clusterA:master:
inconsistent_stopped:1:metro:none:06/06/27/08/31/37
 251:BA_cons1:0000020060406746:clusterB:0000020061413ABA:clusterA:master:
consistent_stopped:4:metro:none:06/06/27/08/31/37
 252:AB_cons2:0000020061413ABA:clusterA:0000020060406746:clusterB::empty:0
:empty_group:none:06/06/27/08/31/37
 253:AB_cons1:0000020061413ABA:clusterA:0000020060406746:clusterB:aux:
consistent_stopped:3:global:none:06/06/27/08/31/37
 254:AA_cons2:0000020061413ABA:clusterA:0000020061413ABA:clusterA::empty:0
:empty_group:none:06/06/27/08/31/37
 255:AA_cons1:0000020061413ABA:clusterA:0000020061413ABA:clusterA:master:
consistent_synchronized:2:global:none:06/06/27/08/31/37

详细调用示例

lsrcconsistgrp -delim : 254

生成的详细输出:

id:254
name:rccstgrp0
master_cluster_id:0000010030A007E5
master_cluster_name:clusterA
aux_cluster_id:0000010030A007E5
aux_cluster_name:clusterA
primary:master
state:consistent_synchronized
relationship_count:1
freeze_time:06/06/27/08/31/37
status:online
sync:in_sync
copy_type:activeactive
cycle_period_seconds:300
previous_primary aux
cycling_mode:none
RC_rel_id:2
RC_rel_name:aaa